home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Skunkware 5
/
Skunkware 5.iso
/
man
/
cat.1
/
tin.1
< prev
next >
Wrap
Text File
|
1995-07-25
|
96KB
|
2,047 lines
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
NNNNAAAAMMMMEEEE
tin, rtin, cdtin, tind - A Netnews reader
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
ttttiiiinnnn////rrrrttttiiiinnnn////ccccddddttttiiiinnnn////ttttiiiinnnndddd [ _o_p_t_i_o_n_s ] [ _n_e_w_s_g_r_o_u_p_s ]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_T_i_n is a full-screen easy to use Netnews reader. It can read
news locally (i.e. /_u_s_r/_s_p_o_o_l/_n_e_w_s) or remotely (_r_t_i_n or _t_i_n
-_r option) via a NNTP (Network News Transport Protocol)
server. _C_d_t_i_n can read news locally and news archived on
CD-ROM. It will automatically utilize nov (news overview)
style index files if available locally or via the nntp xover
command.
_T_i_n has five separate levels of operation: Group selection
level, Spooldir selection level, Group level, Thread level
and Article level. Use the 'h' (help) command to view a
list of the commands available at a particular level.
On startup _t_i_n will show a list of the newsgroups found in
$_H_O_M_E/._n_e_w_s_r_c. An arrow '->' or highlighted bar will point
to the first newsgroup. Move to a group by using the
terminal arrow keys (terminal dependent) or 'j' and 'k'.
Use PgUp/PgDn (terminal dependent) or Ctrl-U and Ctrl-D to
page up/down. Enter a newsgroup by pressing RETURN.
The TAB key advances to the next newsgroup with unread
articles and enters it.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
----cccc create/update index files for every group in
$_H_O_M_E/._n_e_w_s_r_c or file specified by -f option and
mark all articles as read.
----ffff _f_i_l_e use the specified file of subscribed to
newsgroups in place of $_H_O_M_E/._n_e_w_s_r_c.
----hhhh help listing all command line options.
----HHHH brief introduction to _t_i_n that is also shown the
first time it is started.
----IIII _d_i_r directory in which to store newsgroup index
files. Default is $_H_O_M_E/._t_i_n/._i_n_d_e_x.
----mmmm _d_i_r mailbox directory to use. Default is
$_H_O_M_E/_M_a_i_l.
----MMMM _u_s_e_r mail unread articles to specified user for later
reading. For more information read section
Automatic Mailing and Saving New News.
Page 1 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
----nnnn Only load groups from the active file that are
also subscribed to in the users ._n_e_w_s_r_c. This
allows a noticeable speedup when connecting via
a slow line.
----pppp _p_r_o_g_r_a_m print program with options.
----qqqq quick start without checking for new newsgroups.
----PPPP purge group index files of articles that no
longer exist. Care should be taken when using
this command as it stats each and every article
in each group that is accessed. On a low speed
connection this can have an undisirable effect
and it also knocks the hell out of your
filesystem.
----rrrr read news remotely from the default NNTP server
specified in the environment variable NNTPSERVER
or contained in the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r.
----RRRR read news saved by -S option (not yet
implemented).
----ssss _d_i_r save articles to directory. Default is
$_H_O_M_E/_N_e_w_s.
----SSSS save unread articles for later reading by -R
option. For more information read section
Automatic Mailing and Saving New News.
----uuuu create/update index files for every group in
$_H_O_M_E/._n_e_w_s_r_c or file specified by -f option.
This option is disabled if _t_i_n retreives its
index files via a NNTP server.
----UUUU start _t_i_n in the background to update index
files while reading news in the foreground.
This option is disabled if _t_i_n retreives its
index files via a NNTP server.
----vvvv verbose mode for -c -M -S -u and -Z options.
----wwww quick mode to post an article and then exit.
----zzzz only start _t_i_n if there is any new/unread news.
If there is news _t_i_n will position cursor at
first group with unread news. Useful for putting
in login file.
----ZZZZ check if there is any new/unread news and exit
with appropriate status. If -v option is
Page 2 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
specified the number of unread articles in each
group is printed. An exit code 0 indicates no
news, 1 that an error occurred and 2 that
new/unread news exists. Useful for writing
scripts.
_T_i_n can also dynamically change its options by the 'M' menu
command. Any changes are written to $_H_O_M_E/._t_i_n/_t_i_n_r_c.
The index daemon version, _t_i_n_d, only supports the -f, -h, -I
and -v options.
IIIINNNNDDDDEEEEXXXX FFFFIIIILLLLEEEESSSS
In order to keep track of threads, _t_i_n maintains an index
for each newsgroup. There are a number of methods in which
index files can be created and updated.
The simplest method is that each user creates/updates there
own index files that are stored in $_H_O_M_E/._t_i_n/._i_n_d_e_x. This
has the advantage that any user can compile and install _t_i_n,
but the disadvantage is that each user is going to be
creating duplicate files and using precious disk space. A
good way to keep index files updated is by doing a _t_i_n -_U
that will update index files in the background while you are
reading news in the foreground. You can also update index
files via the system batcher cron with the -u option:
30 6 * * * /usr/local/bin/tin -u
A slightly better method is to set _t_i_n setuid news and have
all index files created and updated in the news spool
directory (i.e. /_u_s_r/_s_p_o_o_l/_n_e_w_s/._i_n_d_e_x). This has the
advantage that there will only be one copy of the index
files on each machine on your network, but the disadvantage
is that you will have _t_i_n running setuid news.
A better method is to install the _t_i_n_d index file updating
daemon and have it create and update index files for all
groups in your active file at regular intervals in the news
spool directory (i.e. /_u_s_r/_s_p_o_o_l/_n_e_w_s/._i_n_d_e_x). This has the
advantage that there will only be one copy of the index
files on each machine on your network and _t_i_n must not be
setuid news, but the disadvantage is that you will have to
have news permissions to install _t_i_n_d and root permissions
to install an entry in the cron batcher system to have _t_i_n_d
regularly update index files.
The best method is to install the _t_i_n_d index file updating
daemon on your NNTP server and have it create and update
index files for all groups in your active file at regular
intervals in the news spool directory (i.e.
/_u_s_r/_s_p_o_o_l/_n_e_w_s/._i_n_d_e_x). This has the advantage that there
will only be one copy of the index files on the NNTP server
Page 3 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
for the whole of your network, but the disadvantage is that
you will have to install my NNTP server patches to allow _t_i_n
to retreive index file from your NNTP server and and you
must install an entry in the cron batcher system to have
_t_i_n_d regularly update index files (note that this is the
method we use on our network of 40-50 machines and have not
had any problems).
Entering a group the first time tends to be slow because the
index file must be built from scratch unless the _t_i_n_d update
daemon is being used. To alleviate the slowness start _t_i_n to
create all index files for the groups you subscribe to with
_t_i_n -_u -_v and go for a coffee. Subsequent readings of a
group will cause incremental updating of the index file.
If reading news remotely and locally updating index files
operation will be somewhat slower because the articles must
be retreived from the NNTP server.
NNNNEEEEWWWWSSSS AAAADDDDMMMMIIIINNNNIIIISSSSTTTTRRRRAAAATTTTIIIIOOOONNNN
Maintaining Netnews on large networks of machines can be a
pretty time consuming job as I discovered when I was given
the job of maintaining our news system and news users.
_T_i_n is a News User Agent and so most of the users were
always asking questions or doing things that could be
frowned upon by there departments. To releive news admins
(and especially me) of this features have been added to make
life easier for news adminstrators.
When a user starts _t_i_n it is possible to inform them of any
important changes/information concerning the news system by
displaying a message of the day (motd) file. The motd file
should be created in your news lib directory (i.e.
/_u_s_r/_l_i_b/_n_e_w_s/_m_o_t_d) and should have file permissions set to
0644. The motd file will only be displayed if its contents
is newer than the last time the user started _t_i_n. If reading
news via NNTP my XMOTD patch will have to have been applied
to your NNTP server.
A user starting _t_i_n for the first time can be automatically
subscribed to a list of newsgroups that are deemed
appropriate by the news administrator. At our site the
subscriptions file has 125 groups (our active file contains
over 400 groups with many only being marginally interesting
to most people). The subscriptions file should be created
in your news lib directory (i.e.
/_u_s_r/_l_i_b/_n_e_w_s/_s_u_b_s_c_r_i_p_t_i_o_n_s) and should have file
permissions set to 0644. If reading news via NNTP my LIST
SUBSCRIPTIONS patch will have to have been applied to your
NNTP server.
Page 4 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
If my NNTP XUSER patch has been applied to your NNTP server
you will be able to log the username and machine to your
NNTP logfile for usage statistics.
SSSSCCCCRRRREEEEEEEENNNN FFFFOOOORRRRMMMMAAAATTTT
_T_i_n has five separate levels of operation: Group selection
level, Spooldir selection level, Group level, Thread level
and Article level.
At the Group Selection level the title displays the number
of subscribed groups. The newsgroups are displayed on the
left of the screen with the number of unread articles
displayed on the same line in the middle of the screen.
<Selection Num> <Newsgroup> <Num of unread articles>
i.e.,
1 alt.sources 10
2 comp.sources.misc 3
3 news.software.readers 12
At the Group level the title contains the name of the group,
the number of conversation threads and total number of
articles i.e., alt.sources (7 23). If the group has been
setup not to thread articles (i.e., alt.sources is in
$(_H_O_M_E)/._t_i_n/_u_n_t_h_r_e_a_d) the title will be alt.sources (U 23).
There are two possible display formats as shown below:
<Selection Num> <Unread> <Responses> <Subject> <Author>
i.e.,
1 + 3 Bnews sources? iain@anl433.uucp
2 1 This question has ether@net
or
<Selection Num> <Unread> <Responses> <Subject (longer)>
i.e.,
1 + 3 Bnews sources?
2 1 This question has a longer subject line
At the Article level the page header has the following
format:
<Date posted> <Newsgroup> <Thread 1 of n>
<Article Num> <Subject> <Num of responses in thread>
<Author> <Organization>
<Article body>
i.e.,
24 Jul 15:20:03 GMT alt.sources Thread 1 of 2
Article 452 Bnews sources? 3 responses
iain@anl433.uucp Organization name
<Article boby>
CCCCOOOOMMMMMMMMOOOONNNN MMMMOOOOVVVVIIIINNNNGGGG KKKKEEEEYYYYSSSS
This table shows the common keys/commands for moving at all
five levels within _t_i_n.
Page 5 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
ansi/at386/vt100 Other Terminals
Beginning of list/article HHHHoooommmmeeee 1111 (^^^^RRRR or gggg at article level)
End of list/article EEEEnnnndddd $$$$ (also GGGG at article level)
Page Up PPPPggggUUUUpppp ^^^^UUUU or ^^^^BBBB or bbbb
Page Down PPPPggggDDDDnnnn ^^^^DDDD or ^^^^FFFF or <<<<SSSSPPPPAAAACCCCEEEE>>>>
Line Up UUUUpppp aaaarrrrrrrroooowwww kkkk (not at article level)
Line Down DDDDoooowwwwnnnn aaaarrrrrrrroooowwww jjjj (not at article level)
CCCCOOOOMMMMMMMMOOOONNNN EEEEDDDDIIIITTTTIIIINNNNGGGG CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
An emacs style editing package allows the easy editing of
input strings. An history list allows the easy reuse of
previously entered strings. The following commands are
available when editing a string:
^^^^AAAA,,,,^^^^EEEE move to beginning or end of line, respectively.
^^^^FFFF,,,,^^^^BBBB nondestructive move forward or back one location,
respectively.
^^^^DDDD delete the character currently under the cursor,
or send EOF if no characters in the buffer.
^^^^HHHH,,,,<<<<DDDDEEEELLLL>>>> delete character left of the cursor.
^^^^KKKK delete from cursor to end of line.
^^^^PPPP,,,,^^^^NNNN move through history, previous and next,
respectively.
^^^^LLLL,,,,^^^^RRRR redraw the current line.
<<<<CCCCRRRR>>>> places line on history list if nonblank, appends
newline and returns to the caller.
<<<<EEEESSSSCCCC>>>> aborts the present editing operation.
NNNNEEEEWWWWSSSSGGGGRRRROOOOUUUUPPPP SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
4444 Select group 4.
^^^^KKKK Delete current group from $_H_O_M_E/._n_e_w_s_r_c file.
^^^^LLLL Redraw page.
^^^^RRRR Reset $_H_O_M_E/._n_e_w_s_r_c file.
<<<<CCCCRRRR>>>> Read current group.
<<<<TTTTAAAABBBB>>>> View next group with unread news. Will wrap around
to the beginning of the group selection list
looking for unread groups.
BBBB Mail a bug report or comment to the author. This
Page 6 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
is the best way of getting bugs fixed and features
added/changed.
cccc Mark current group as all read with confirmation
and goto next group in group selection list.
CCCC Mark current group as all read and goto next
unread group in group selection list.
dddd Toggle display to show just the groupname or the
groupname and the groups description.
gggg Choose a new group by name. The position of the
group within the group list will also be asked
for. By entering '1' the new group will be the
first group in the displayed list, by entering '8'
the group will be the eighth group in the list
etc. By entering '$' the group will be the last
group displayed.
hhhh Help screen of newsgroup selection commands.
HHHH Toggle the display of help mini menu at the bottom
of the screen.
IIII Toggle inverse video.
llll List and allow selection of the available spool
directories. This feature requires a special
library to be linked with _t_i_n to create _c_d_t_i_n
which can then read news from an active news feed
and also from multiple CD-ROMs.
mmmm Move the current group within the group selection
list. By entering '1' the group will become the
first displayed group in the list, by entering '8'
the eighth group in the list etc. By entering '$'
the group will be the last group displayed.
MMMM User configurable options menu (for more
information see section Options Menu).
qqqq Quit _t_i_n.
QQQQ Quit _t_i_n.
rrrr Toggle display of all subscribed to groups and
just the subscribed to groups containing unread
articles. Command has no effect if groups were
read from the command line when _t_i_n was started.
ssss Subscribe to current group.
Page 7 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
SSSS Subscribe to groups matching user specified
pattern.
uuuu Unsubscribe to current group.
UUUU Unsubscribe to groups matching user specified
pattern.
vvvv Print _t_i_n version information.
wwww Post an article to current group.
WWWW List articles posted by user. The date posted,
the newsgroup and the subject are listed.
yyyy The first time this command is called it will yank
in all groups from $_L_I_B_D_I_R/_a_c_t_i_v_e that are not in
$_H_O_M_E/._n_e_w_s_r_c. After any groups have been
subscribed/unsubscribed to, this command if
pressed again will reread $_H_O_M_E/._n_e_w_s_r_c and
display only the subscribed groups.
YYYY Reread the active file to see if any new news has
arrived since starting _t_i_n.
zzzz Mark all articles in the current group as unread.
ZZZZ Undelete previously deleted group by ^K command
from $_H_O_M_E/._n_e_w_s_r_c.
//// Group forward search.
???? Group backward search.
SSSSPPPPOOOOOOOOLLLL DDDDIIIIRRRREEEECCCCTTTTOOOORRRRYYYY SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
4444 Select spool directory 4.
^^^^LLLL Redraw page.
<<<<CCCCRRRR>>>> Read news from selected spool directory.
BBBB Mail a bug report or comment to the author. This
is the best way of getting bugs fixed and features
added/changed.
hhhh Help screen of spool directory selection commands.
HHHH Toggle the display of help mini menu at the bottom
of the screen.
IIII Toggle inverse video.
Page 8 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
qqqq Return to previous level.
QQQQ Quit _t_i_n.
vvvv Print _t_i_n version information.
GGGGRRRROOOOUUUUPPPP IIIINNNNDDDDEEEEXXXX CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
4444 Select article 4.
^^^^KKKK Kill current article (for more information read
section Kill Article Menu).
^^^^LLLL Redraw page.
<<<<CCCCRRRR>>>> Read current article.
<<<<TTTTAAAABBBB>>>> View next unread article or group.
aaaa Author forward search.
AAAA Author backward search.
cccc Mark all articles as read with confirmation.
CCCC Mark all articles as read and goto next group with
unread news.
dddd Toggle display to show just the subject or the
subject and author.
gggg Choose a new group by name.
hhhh Help screen of group index commands.
HHHH Toggle the display of help mini menu at the bottom
of the screen.
IIII Toggle inverse video.
KKKK Mark article/thread as read and advance to next
unread article/thread.
llll List the author of each response in current thread
and enter thread selection level.
mmmm Mail current article / thread / auto selected
(hot) articles / articles matching pattern /
tagged articles to someone.
MMMM User configurable options menu (for more
information see section Options Menu).
Page 9 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
nnnn Go to next group.
NNNN Go to next unread article.
oooo Output current article / thread / auto selected
(hot) articles / articles matching pattern /
tagged articles to printer.
pppp Go to previous group.
PPPP Go to previous unread article.
qqqq Return to previous level.
QQQQ Quit _t_i_n.
ssss Save current article / thread / auto selected
(hot) articles / articles matching pattern /
tagged articles to file / files / mailbox. To
save to a mailbox enter '=' or '=mailbox' when
asked for filename to save to. To save in
<newsgroup name>/<filename> format enter
'+filename'. Environment variables are allowed
within a filename (i.e. $_S_O_U_R_C_E_S/_d_i_r/_f_i_l_e_n_a_m_e).
tttt Tag current article / thread for mailing ('m') /
piping ('|') / printing ('o') / saving ('s') /
crossposting ('x').
uuuu Toggle display to show all articles as unthreaded
or threaded.
UUUU Untag all articles that were tagged.
vvvv Print _t_i_n version information.
wwww Post an article to current group.
WWWW List articles posted by user. The date posted,
the newsgroup and the subject are listed.
xxxx Crosspost already posted current article / thread
/ auto selected (hot) articles / articles matching
pattern / tagged articles to another newsgroup(s).
Useful for reposting from global to local
newsgroups.
XXXX Mark all unread articles that have not been
selected as read, redo screen to reflect changes
and put index at the first thread to begin
reading. Pressing 'X' again will toggle back to
the way it was before. See '~' command for
Page 10 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
clearing the toggle effect.
zzzz Mark current article as unread.
ZZZZ Mark current thread as unread.
//// Search forward for specified subject.
???? Search backward for specified subject.
---- Show last message.
|||| Pipe current article / thread / auto selected
(hot) articles / articles matching pattern /
tagged articles into command.
**** Select current thread for later processing.
TTTToooogggggggglllleeee sssseeeelllleeeeccccttttiiiioooonnnn ooooffff ccccuuuurrrrrrrreeeennnntttt tttthhhhrrrreeeeaaaadddd.... IIIIffff aaaatttt lllleeeeaaaasssstttt oooonnnneeee uuuunnnnrrrreeeeaaaadddd aaaarrrrtttt,,,,
but not all unread arts, in thread is selected,
then all unread arts become selected.
@@@@ Reverse all selections on all articles.
~~~~ Undo all selections on all articles. It clears the
toggle effect of 'X' command. Thus after first
doing a 'X', one can then do '~' to reset
articles. Thus, one can iteratively whittle down
uninteresting threads.
++++ Perform auto-selection on current group.
;;;; For each thread in current group, if it at least
one unread art is selected, all unread arts become
selected. This is useful for auto-selection on
author where reader wants to see entire thread.
==== Prompts for a pattern with which to match on. All
threads whose subjects match the pattern will be
selected. A pattern of "*" will match all
subjects. Entering just <CR> will cause the
previous pattern to be used.
TTTTHHHHRRRREEEEAAAADDDD LLLLIIIISSSSTTTTIIIINNNNGGGG CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
4444 Select article 4 within thread.
^^^^LLLL Redraw page.
<<<<CCCCRRRR>>>> Read current article within thread.
<<<<TTTTAAAABBBB>>>> View next unread article within thread.
Page 11 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
BBBB Mail a bug report or comment to the author. This
is the best way of getting bugs fixed and features
added/changed.
cccc Mark thread as read after confirmation and return
to previous level.
dddd Toggle display to show just the subject or the
subject and author.
hhhh Help screen of thread listing commands.
HHHH Toggle the display of help mini menu at the bottom
of the screen.
IIII Toggle inverse video.
KKKK Mark thread as read and return to previous level.
qqqq Return to previous level.
QQQQ Quit _t_i_n.
rrrr Toggle display to show all articles or only unread
articles.
BBBB Mail a bug report or comment to the author. This
is the best way of getting bugs fixed and features
added/changed.
tttt Tag current article for mailing ('m') / piping
('|') / printing ('o') / saving ('s') /
crossposting ('x').
TTTT Return to group index level.
vvvv Print _t_i_n version information.
zzzz Mark current article in thread as unread.
ZZZZ Mark all articles in thread as unread.
AAAARRRRTTTTIIIICCCCLLLLEEEE VVVVIIIIEEEEWWWWEEEERRRR CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
0000 Read the base article in this thread.
4444 Read response 4 in this thread.
^^^^HHHH Show all of the articles mail header.
^^^^KKKK Kill current article (for more information read
section Kill Article Menu).
Page 12 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
^^^^LLLL Redraw page.
<<<<CCCCRRRR>>>> Goto next base article.
<<<<TTTTAAAABBBB>>>> Goto next unread article.
aaaa Author forward search.
AAAA Author backward search.
cccc Mark all articles as read with confirmation and
return to group selection level.
CCCC Mark current group as all read and goto next
unread group in group selection list.
dddd Toggle rot-13 decoding for this article.
DDDD Delete current article. It must have been posted
by the same user. The cancel message can be seen
in the newsgroup 'control'.
ffff Post a followup to the current article with a copy
of the article included.
FFFF Post a followup to the current article.
hhhh Help screen of article page commands.
HHHH Toggle the display of help mini menu at the bottom
of the screen.
IIII Toggle inverse video.
kkkk Mark article as read and advance to next unread
article.
KKKK Mark thread as read and advance to next unread
thread.
mmmm Mail current article / thread / auto selected
(hot) articles / articles matching pattern /
tagged articles to someone.
MMMM User configurable options menu (for more
information see section Options Menu).
nnnn Go to the next article.
NNNN Go to the next unread article.
oooo Output current article / thread / auto selected
Page 13 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
(hot) articles / articles matching pattern /
tagged articles to printer.
oooo Output article/thread/tagged articles to printer.
pppp Go to the previous article.
PPPP Go to the previous unread article.
qqqq Return to previous level.
QQQQ Quit _t_i_n.
rrrr Reply through mail to the author of the current
article with a copy of the article included.
RRRR Reply through mail to the author of the current
article.
ssss Save current article / thread / auto selected
(hot) articles / articles matching pattern /
tagged articles to file / files / mailbox. To
save to a mailbox enter '=' or '=mailbox' when
asked for filename to save to. To save in
<newsgroup name>/<filename> format enter
'+filename'. Environment variables are allowed
within a filename (i.e. $_S_O_U_R_C_E_S/_d_i_r/_f_i_l_e_n_a_m_e).
tttt Return to group selection level.
TTTT Tag current article for mailing ('m') / piping
('|') / printing ('o') / saving ('s') /
crossposting ('x').
vvvv Print _t_i_n version information.
wwww Post an article to current group.
WWWW List articles posted by user. The date posted,
the newsgroup and the subject are listed.
xxxx Crosspost already posted current article / thread
/ auto selected (hot) articles / articles matching
pattern / tagged articles to another newsgroup(s).
Useful for reposting from global to local
newsgroups.
zzzz Mark article as unread.
//// Article forward search.
???? Article backward search
Page 14 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
|||| Pipe current article / thread / auto selected
(hot) articles / articles matching pattern /
tagged articles into command.
<<<< Goto the first article in the current thread.
>>>> Goto the last article in the current thread.
**** Select current thread for later processing.
TTTToooogggggggglllleeee sssseeeelllleeeeccccttttiiiioooonnnn ooooffff ccccuuuurrrrrrrreeeennnntttt aaaarrrrttttiiiicccclllleeee....
@@@@ Reverse article selections.
~~~~ Undo all selections on current thread.
GGGGLLLLOOOOBBBBAAAALLLL OOOOPPPPTTTTIIIIOOOONNNNSSSS MMMMEEEENNNNUUUU
This menu is accessed by pressing 'M' at all levels. It
allows the user to customize the behaviour of _t_i_n. The
options are saved to the file $_H_O_M_E/._t_i_n/_t_i_n_r_c. Use <SPACE>
to toggle the required option and <CR> to set.
AAAAuuuuttttoooo ssssaaaavvvveeee
Automatically save articles/threads by ``Archive-name:''
line in article header and post process them if process
type is not set to None.
EEEEddddiiiittttoooorrrr ooooffffffffsssseeeetttt
Set ON if the editor used for posting, follow-ups and
bug reports has the capability of starting and
positioning the cursor at a specified line within a
file.
MMMMaaaarrrrkkkk ssssaaaavvvveeeedddd rrrreeeeaaaadddd
Allows saved articles/threads to be automatically marked
as read.
CCCCoooonnnnffffiiiirrrrmmmm CCCCoooommmmmmmmaaaannnndddd
Allows certain commands (i.e. 'c' catchup) that require
user confirmation to be executed immediately if set OFF.
DDDDrrrraaaawwww aaaarrrrrrrroooowwww
Allows groups/articles to be selected by an arrow '->'
if set ON or by an highlighted bar if set OFF.
PPPPrrrriiiinnnntttt hhhheeeeaaaaddddeeeerrrr
This allows the complete mail header or only the
``Subject:'' and ``From:'' fields to be output when
printing articles.
GGGGoooottttoooo 1111sssstttt uuuunnnnrrrreeeeaaaadddd
This allows the cursor to be placed at the first / last
Page 15 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
unread article upon entering a newsgroup with unread
news.
SSSSccccrrrroooollllllll ffffuuuullllllll ppppaaaaggggeeee
If set ON scrolling of groups/articles will be a full
page at a time, otherwise half a page at a time.
CCCCaaaattttcccchhhhuuuupppp oooonnnn qqqquuuuiiiitttt
If set ON the user is asked when quitting if all groups
read during the current session should be marked read.
TTTThhhhrrrreeeeaaaadddd aaaarrrrttttiiiicccclllleeeessss
If set ON articles will be threaded in all groups
(default), otherwise articles will be shown unthreaded.
Threading/unthreading is possible on a per group basis
by setting the group attribute variable 'thread_arts' to
ON/OFF in the file $_H_O_M_E/._t_i_n/_a_t_t_r_i_b_u_t_e_s.
SSSShhhhoooowwww oooonnnnllllyyyy uuuunnnnrrrreeeeaaaadddd
If set ON show only new/unread articles, otherwise show
all articles.
SSSShhhhoooowwww ddddeeeessssccccrrrriiiippppttttiiiioooonnnn
If set ON show a short descriptive text for each
displayed newsgroup. The text used is taken from the
$_L_I_B_D_I_R/_n_e_w_s_g_r_o_u_p_s file.
SSSShhhhoooowwww AAAAuuuutttthhhhoooorrrr
If set 'None' only the ``Subject:'' line will be
displayed. If set 'Addr' ``Subject:'' line & the
address part of the ``From:'' line are displayed. If
set 'Name' ``Subject:'' line & the authors full name
part of the ``From:'' line are displayed. If set 'Both'
``Subject:'' line & all of the ``From:'' line are
displayed.
PPPPrrrroooocccceeeessssssss ttttyyyyppppeeee
This specifies the default type of post processing to
perform on saved articles. The following types of
processing are allowed:
-none.
-unpacking of multi-part shell archives.
-unpacking of multi-part uuencoded files.
-unpacking of multi-part uuencoded files, which
produce a *.zoo archive whose contents is listed.
-unpacking of multi-part uuencoded files, which
produce a *.zoo archive whose contents is
extracted.
-unpacking of multi-part uuencoded files, which
produce a *.zip archive whose contents is listed.
-unpacking of multi-part uuencoded files, which
produce a *.zip archive whose contents is
Page 16 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
extracted.
-unpacking of multi-part uuencoded files, which
produce a *.lha archive whose contents is listed
(AmigaDOS version only).
-unpacking of multi-part uuencoded files, which
produce a *.lha archive whose contents is extracted
(AmigaDOS version only).
SSSSoooorrrrtttt aaaarrrrttttiiiicccclllleeeessss bbbbyyyy
This specifies how articles should be sorted. The
following sort types are allowed:
-don't sort articles (default).
-sort articles by ``Subject:'' field (ascending &
descending).
-sort articles by ``From:'' field (ascending &
descending).
-sort articles by ``Date:'' field (ascending &
descending).
SSSSaaaavvvveeee ddddiiiirrrreeeeccccttttoooorrrryyyy
The directory where articles/threads are to be saved.
Default is $_H_O_M_E/_N_e_w_s.
MMMMaaaaiiiillll ddddiiiirrrreeeeccccttttoooorrrryyyy
The directory where articles/threads are to be saved in
mailbox format. This feature is mainly for use with the
Elm mail program. It allows the user to save
articles/threads/groups simply by giving '=' as the
filename to save to.
PPPPrrrriiiinnnntttteeeerrrr
The printer program with options that is to be used to
print articles. Default is lpr for BSD machines and lp
for SysV machines.
TTTTIIIINNNNRRRRCCCC CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAABBBBLLLLEEEE VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
The following variables are user configurable by editing
$_H_O_M_E/._t_i_n/_t_i_n_r_c directly. It is hoped to eventually provide
a menu to allow the setting of the most common variables.
bbbbaaaattttcccchhhh____ssssaaaavvvveeee
If set ON articles/threads will be saved in batch mode
when save -S or mail -M is specified on the command
line. Default is OFF.
bbbbeeeeggggiiiinnnnnnnneeeerrrr____lllleeeevvvveeeellll
If set ON a mini menu of the most useful commands will
be displayed at the bottom of the screen for each level.
Default is ON.
ddddiiiissssppppllllaaaayyyy____rrrreeeeaaaaddddiiiinnnngggg____pppprrrroooommmmpppptttt
The prompt ``Reading...'' will be displayed when reading
Page 17 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
an article from a NNTP server to provide feedback to the
user. Default is ON.
ffffoooorrrrcccceeee____ssssccccrrrreeeeeeeennnn____rrrreeeeddddrrrraaaawwww
Specifies whether a screen redraw should always be done
after certain external commands. Default is OFF.
ggggrrrroooouuuuppppnnnnaaaammmmeeee____mmmmaaaaxxxx____lllleeeennnnggggtttthhhh
Maximum length of the names of newsgroups to be
displayed so that more of the newgroup description can
be displayed. Default is 132.
ddddeeeeffffaaaauuuulllltttt____ssssiiiiggggffffiiiilllleeee
The path that specifies the signature file to use when
posting, following upto or replying to an article. If
the path is a directory then the signature will be
randomly generated from files that are in the specified
directory. Default is $_H_O_M_E/._S_i_g.
eeeeddddiiiittttoooorrrr____ffffoooorrrrmmmmaaaatttt
The format string used to create the editor start
command with parameters. Default is '%E +%N %F' (i.e.,
/bin/vi +7 .article).
hhhhooootttt____aaaarrrrtttt____mmmmaaaarrrrkkkk
The character used to show that an article/thread is
auto-selected (hot). Default is '*'.
qqqquuuuooootttteeee____cccchhhhaaaarrrrssss
The character used in quoting included text to article
followups and mail replys. The '_' character represents
a blank character and is replaced with ' ' when read.
Default is ':_'.
rrrreeeerrrreeeeaaaadddd____aaaaccccttttiiiivvvveeee____ffffiiiilllleeee____sssseeeeccccssss
The news active file is reread at regular intervals to
show if any new news has arrived. Default is 300
seconds.
rrrreeeettttuuuurrrrnnnn____aaaarrrrtttt____mmmmaaaarrrrkkkk
The character used to show that an article will return.
Default is '-'.
ssssaaaavvvveeee____ttttoooo____mmmmmmmmddddffff____mmmmaaaaiiiillllbbbbooooxxxx
Allows articles to be saved to a MMDF style mailbox
instead of mbox format. Default is OFF unless reading
news on SCO Unix which uses MMDF by default.
sssshhhhoooowwww____llllaaaasssstttt____lllliiiinnnneeee____pppprrrreeeevvvv____ppppaaaaggggeeee
The last line of the previous page will be displayed as
the first line of next page. Default is OFF.
Page 18 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
sssslllloooowwww____ssssppppeeeeeeeedddd____tttteeeerrrrmmmmiiiinnnnaaaallll
Strips the blanks from the end of each line therefore
speeding up the display when reading on a slow terminal
or via modem. Default is OFF.
ttttaaaabbbb____aaaafffftttteeeerrrr____XXXX____sssseeeelllleeeeccccttttiiiioooonnnn
If enabled will automatically goto the first unread
article after having selected all hot articles and
threads with the 'X' command at group index level.
Default is OFF.
ttttaaaabbbb____ggggoooottttoooo____nnnneeeexxxxtttt____uuuunnnnrrrreeeeaaaadddd
If enabled pressing TAB at the article viewer level will
goto the next unread article immediately instead of
first paging through the current one. Default is ON.
uuuunnnnrrrreeeeaaaadddd____aaaarrrrtttt____mmmmaaaarrrrkkkk
The character used to show that an article has not been
read. Default is '+'.
uuuusssseeee____bbbbuuuuiiiillllttttiiiinnnn____iiiinnnneeeewwwwssss
Allows the builtin NNTP inews to be enabled/disabled.
Default is ON (enabled).
uuuusssseeee____kkkkeeeeyyyyppppaaaadddd
Allows the scroll keys on the keypad to be
enabled/disabled on supported terminals. Default is OFF.
GGGGRRRROOOOUUUUPPPP AAAATTTTTTTTRRRRIIIIBBBBUUUUTTTTEEEESSSS
_T_i_n allows certain attributes to be set on a per group
basis. These group attributes are read from the file
$_H_O_M_E/._t_i_n/_a_t_t_r_i_b_u_t_e_s. A later version will provide a menu
interface to set all the attributes. At present you will
have to edit the file with your editor :-(. The following
group attributes are available:
newsgroup=alt.sources
maildir=/usr/iain/Mail/sources
savedir=/usr/iain/News/alt.sources
sigfile=/usr/iain/.funny_sig
organization=Wacky Bits Inc.
followup_to=alt.sources.d
printer=/usr/local/bin/a2ps -nn | /bin/lpr
auto_save=ON
batch_save=OFF
delete_tmp_files=ON
show_only_unread=OFF
thread_arts=ON
show_author=1
sort_art_type=5
post_proc_type=1
Page 19 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
Note that the ''newsgroup=<groupname>'' line has to be
specified before the attributes are specified for that
group.
All attributes are set to a reasonable default so you only
have to specify the attribute that you want to change (i.e.,
savedir).
All toggle attributes are set by specifying ON/OFF.
The show_author attribute is specified by a number from the
following range: 0=none, 1=username, 2=network address,
3=both.
The sort_art_type attribute is specified by a number from
the following range: 0=none, 1=subject descending, 2=subject
ascending, 3=from descending, 4=from ascending, 5=date
descending, 6=date ascending.
The post_proc_type attribute is specified by a number from
the following range: 0=none, 1=unshar, 2=uudecode,
3=uudecode & list zoo archive, 4=uudecode & extract zoo
archive, 5=uudecode & list zip archive, 6=uudecode & extract
zip archive. (note: if running on AmigaDOS the zoo options
are replaced by there corresponding lha archiver options).
AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC KKKKIIIILLLLLLLL AAAANNNNDDDD SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
When there is a subject or an author which you are either
very interested in, or find completely uninteresting, you
can easily instruct _t_i_n to _a_u_t_o-_s_e_l_e_c_t or _a_u_t_o-_k_i_l_l articles
with specific subjects or from specific authors. These
instructions are stored in a _k_i_l_l _f_i_l_e.
This menu is accessed by pressing '^K' at the group and page
levels. It allows the user to kill or select an article
that matches the current ``Subject:'' line, ``From:'' line
or a string entered by the user. The user entered string can
be applied to the ``Subject:'' or ``From:'' lines of an
article. The kill description can be limited to the current
newsgroup or it can apply to all newsgroups. Once entered
the user can abort the command and not save the kill
description, edit the kill file or save the kill
description.
On starting _t_i_n the users killfile $_H_O_M_E/._t_i_n/_k_i_l_l is read
and on entering a newsgroup any kill or select descriptions
are applied.
Articles that match a kill description are marked killed and
are not displayed. Articles that match an auto-select
description are marked with a ''*'' when displayed.
Page 20 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
PPPPOOOOSSSSTTTTIIIINNNNGGGG AAAARRRRTTTTIIIICCCCLLLLEEEESSSS
_T_i_n allows posting of articles, follow-up to already posted
articles and replying direct through mail to the author of
an article.
Use the 'w' command to post an article to a newsgroup.
After entering the post subject the default editor (i.e. vi)
or the editor specified by the $VISUAL environment variable
will be started and the article can be entered. To
crosspost articles simply add a comma and the name of the
newsgroup(s) to the end of the ``Newsgroups:'' line at the
beginning of the article. After saving and exiting the
editor you are asked if you wish to a)bort posting the
article, e)dit the article again or p)ost the article to the
specified newsgroup(s).
Use the 'W' command to display a history of the articles you
have posted. The date the article was posted, which
newsgroups the article was posted to and the articles
subject line are displayed.
Use the 'f' / 'F' command to post a follow-up article to an
already posted article. The 'f' command will copy the text
of the original article into the editor. The editing
procedure is the same as when posting an article with the
'w' command.
Use the 'r' / 'R' command to reply direct through mail to
the author of an already posted article. The 'r' command
will copy the text of the original article into the editor.
The editing procedure is the same as when posting an article
with the 'w' command. After saving and exiting the editor
you are asked if you wish to a)bort sending the article,
e)dit the article again or s)end the article to the author.
CCCCUUUUSSSSTTTTOOOOMMMMIIIIZZZZIIIINNNNGGGG TTTTHHHHEEEE AAAARRRRTTTTIIIICCCCLLLLEEEE QQQQUUUUOOOOTTTTEEEE SSSSTTTTRRRRIIIINNNNGGGG
When posting a followup to an article or replying direct to
the author of an article via email the text of the article
can be quoted. The beginning of the quoted text can contain
information about the quoted article (i.e., Name and the
Message Id of the article). To allow for different
situations certain information from the article can be used
in the quoted string. The following variables are expanded
if found in the tinrc variables 'mail_quote_format=' or
'news_quote_format=':
%%%%AAAA Address (Email)
%%%%DDDD Date
%%%%FFFF Full address (%N (%A))
%%%%GGGG Groupname
%%%%MMMM Message Id
%%%%NNNN Name of user
i.e.,
Page 21 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
mail_quote_format=On %D in %G you wrote:
news_quote_format=In %M, %F wrote:
would expand when used to:
On 21 Jul 1992 09:45:51 -0400 in alt.sources you wrote:
In <abcINN123@anl433.uucp>, Iain Lea (iain@erlm.siemens.de) wrote:
MMMMAAAAIIIILLLLIIIINNNNGGGG PPPPIIIIPPPPIIIINNNNGGGG PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG RRRREEEEPPPPOOOOSSSSTTTTIIIINNNNGGGG AAAANNNNDDDD SSSSAAAAVVVVIIIINNNNGGGG AAAARRRRTTTTIIIICCCCLLLLEEEESSSS
The command interface to mail ('m'), pipe ('|'), print
('o'), crosspost ('x') and save ('s') articles is the same
for ease of use.
The initial command will ask you to select which a)rticle,
t)hread, h)ot (auto selected) r)egex pattern, t)agged
articles you wish to mail, pipe etc.
Tagged articles must have already been tagged with the 'T'
command. All tagged articles can be untagged by the 'U'
untag command.
If regex pattern matching is selected you are asked to enter
a regular expression (i.e. to match all articles subject
lines containing 'net News' you must enter '*net News*').
Any articles that match the entered expression will be
mailed, piped etc.
To save articles to a mailbox with the name of the current
newsgroup (i.e. Alt.sources) enter '=' or '=<mailbox name>'
when asked for the save filename.
To save articles in <newsgroup name>/<filename> format enter
'+<filename>'.
When saving articles you can specify whether the saved files
should be post processed (i.e. unshar shell archive,
uudecode multiple parts etc). A default process type can be
set by the 'Process type:' in the 'M' options menu.
AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC MMMMAAAAIIIILLLLIIIINNNNGGGG AAAANNNNDDDD SSSSAAAAVVVVIIIINNNNGGGG NNNNEEEEWWWW NNNNEEEEWWWWSSSS
_T_i_n allows new/unread news articles to be mailed (-M
option)/saved (-S option) in batch mode for later reading.
Useful when going on holiday and you don't want to return
and find that expire has removed a whole load of unread
articles. Best to run from crontab everyday while away,
after which you will be mailed a report of which articles
were mailed/saved from which newsgroups and the total number
of articles mailed/saved. Articles are saved in a private
news structure under your <savedir> directory (default is
$_H_O_M_E/_N_e_w_s). Be careful of using this option if you read a
lot of groups because you could overflow your filesystem.
If you only want to save a few groups it would be best to
backup your full $_H_O_M_E/._n_e_w_s_r_c and create a new one that
only contains the newsgroups you want to mail/save. Saved
Page 22 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
news can be read later by _t_i_n -_R.
_t_i_n -_M _i_a_i_n -_c -_f _n_e_w_s_r_c._m_a_i_l
(mail any unread articles in newgroups
specified in file newsrc.mail)
_t_i_n -_S -_c -_f _n_e_w_s_r_c._s_a_v_e
(save any unread articles in newgroups
specified in file newsrc.save)
_t_i_n -_R (read any articles saved by _t_i_n -_S)
SSSSIIIIGGGGNNNNAAAATTTTUUUURRRREEEESSSS
_T_i_n will recognize a signature in either $_H_O_M_E/._s_i_g_n_a_t_u_r_e or
$_H_O_M_E/._S_i_g. If $_H_O_M_E/._s_i_g_n_a_t_u_r_e exists, then the signature
will be pulled into the editor for mail commands. A
signature in $_H_O_M_E/._s_i_g_n_a_t_u_r_e will not be pulled into the
editor for posting commands since _i_n_e_w_s will append the
signature itself.
A signature in $_H_O_M_E/._S_i_g will be pulled into the editor for
both posting and mailing commands.
The following is an example of a $_H_O_M_E/._S_i_g file:
NAMES Iain Lea iain.lea@erlm.siemens.de
SNAIL Bruecken Strasse 12, 8500 Nuernberg 90, Germany
PHONE +49-911-331963 (home) +49-911-3089-407 (work)
_T_i_n also has the capability to generate random signatures on
a per newsgroup basis if so desired. The way to accomplish
this is to specify the default signature or the group
attribute sigfile as a directory. If for example the
sigfile path is /_u_s_r/_i_a_i_n/._s_i_g_s and ._s_i_g_s is a directory
then _t_i_n will select a random signature from any file that
is in the directory ._s_i_g_s (note: one signature per numbered
file). A random signature can also consist of a fixed part
signature that can contain your name, address etc. followed
by the random sig. The fixed part of the random sig is read
from the file $_H_O_M_E/._s_i_g_f_i_x_e_d.
EEEENNNNVVVVIIIIRRRROOOOMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
TTTTIIIINNNNRRRRCCCC
Define this variable if you want to specify command
line options that _t_i_n should be started with to save
typing them each time it is started. The contents of
the environment variable are added to the front of the
command line options before it is parsed therefore
allowing an option specified on the command line to
override the same option specified in the environment.
TTTTIIIINNNN____HHHHOOOOMMMMEEEEDDDDIIIIRRRR
Define this variable if you do not want the .tin
directory in $_H_O_M_E/._t_i_n. (i.e. if you want all tin's
Page 23 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
private files in /_t_m_p/._t_i_n you would set TINDIR to
/_t_m_p.
TTTTIIIINNNN____IIIINNNNDDDDEEEEXXXXDDDDIIIIRRRR
Define this variable if you do not want the .index
directory in $_H_O_M_E/._t_i_n/._i_n_d_e_x. (i.e. if you want all
tin's index files in /_t_m_p/._i_n_d_e_x you would set
TIN_INDEXDIR to /_t_m_p.
TTTTIIIINNNN____LLLLIIIIBBBBDDDDIIIIRRRR
Define this variable if you want to override the LIBDIR
path that was compiled into the tin binary via the
Makefile.
TTTTIIIINNNN____SSSSPPPPOOOOOOOOLLLLDDDDIIIIRRRR
Define this variable if you want to override the
SPOOLDIR path that was compiled into the tin binary via
the Makefile.
TTTTIIIINNNN____NNNNOOOOVVVVRRRROOOOOOOOTTTTDDDDIIIIRRRR
Define this variable if you want to override the
NOVROOTDIR path that was compiled into the tin binary
via the Makefile.
TTTTIIIINNNN____AAAACCCCTTTTIIIIVVVVEEEEFFFFIIIILLLLEEEE
Define this variable if you want to override the
LIBDIR/active path that was compiled into the tin
binary via the Makefile.
NNNNNNNNTTTTPPPPSSSSEEEERRRRVVVVEEEERRRR
The default NNTP server to remotely read news from.
This variable only needs to be set if the -r command
line option is specified and the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r
does not exist.
DDDDIIIISSSSTTTTRRRRIIIIBBBBUUUUTTTTIIIIOOOONNNN
Set the article header field ``Distribution:'' to the
contents of the variable instead of the system default.
OOOORRRRGGGGAAAANNNNIIIIZZZZAAAATTTTIIIIOOOONNNN
Set the article header field ``Organization:'' to the
contents of the variable instead of the system default.
This variable has precedence over the file
$_H_O_M_E/._t_i_n/_o_r_g_a_n_i_z_a_t_i_o_n that may also contain an
organization string. If reading news on an Apollo
DomainOS machine the environment variable NEWSORG has
to be used instead of ORGANIZATION.
RRRREEEEPPPPLLLLYYYYTTTTOOOO
Set the article header field ``Reply-To:'' to the
return address specified by the variable. This is
useful if the machine is not registered in the UUCP
Page 24 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
mail maps or if you wish to receive replies at a
different machine. This variable has precedence over
the file $_H_O_M_E/._t_i_n/_r_e_p_l_y_t_o that may also contain a
return address.
AAAADDDDDDDD____AAAADDDDDDDDRRRREEEESSSSSSSS
This can contain an address to append to the return
address when replying directly through mail to somebody
whose mail address is not directly recognized by the
local host. For example say the return address is
_u_s_e_r@_b_i_g_v_a_x, but _b_i_g_v_a_x is not recognized by your host,
so therefore the mail will not reach _u_s_e_r. But the
host _l_i_t_t_e_v_a_x is known to recognize your host and
_b_i_g_v_a_x, so if ADD_ADDRESS is set (i.e. 'setenv
ADD_ADDRESS @littevax' for csh or 'set ADD_ADDRESS
@littevax' and 'export ADD_ADDRESS' for sh) the address
_u_s_e_r@_b_i_g_v_a_x@_l_i_t_t_l_e_v_a_x will be used and the mail will
reach _u_s_e_r@_b_i_g_v_a_x. This variable has precedence over
the file $_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s that may also contain
an address.
BBBBUUUUGGGG____AAAADDDDDDDDRRRREEEESSSSSSSS
If the 'B' command bug report mail address is not
correct this variable should be set to the correct mail
address. This variable has precedence over the file
$_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s that may also contain a mail
address.
MMMMAAAAIIIILLLLEEEERRRR
This variable has precedence over the default mailer
that is used in all mailing operations within _t_i_n (i.e.
replying 'rR', and bug reports 'B').
VVVVIIIISSSSUUUUAAAALLLL
This variable has precedence over the default editor
(i.e. vi) that is used in all editing operations within
_t_i_n (i.e. posting 'w', replying 'rR', follow-ups 'fF'
and bug reports 'B').
AAAAUUUUTTTTOOOOSSSSUUUUBBBBSSSSCCCCRRRRIIIIBBBBEEEE
_t_i_n interprets this variable similarly to rn. It
contains a list of patterns, separated by commas and
possibly prefixed with exclamation points. A new group
is checked against the list of patterns; if it matches,
_t_i_n subscribes the user to the group without further
query. An exclamation point negates the meaning of a
match on this pattern, and can be used to cancel
certain matches. For example, setting
_A_U_T_O_S_U_B_S_C_R_I_B_E=_c_o_m_p._o_s._u_n_i_x.*,_t_a_l_k.*,!_t_a_l_k._p_o_l_i_t_i_c_s.*
will automatically subscribe the user to all new groups
in the comp.os.unix hierarchy, and all talk groups
other than talk.politics groups (which will be queried
Page 25 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
for as usual.)
AAAAUUUUTTTTOOOOUUUUNNNNSSSSUUUUBBBBSSSSCCCCRRRRIIIIBBBBEEEE
_t_i_n interprets this variable similarly to rn. It is
handled like the _A_U_T_O_S_U_B_S_C_R_I_B_E variable, but groups
matching the list are unsubscribed from without further
query. For example, setting
_A_U_T_O_U_N_S_U_B_S_C_R_I_B_E=_a_l_t._f_l_a_m_e.*,_u*,!_u_k.* will automatically
unsubscribe the user from all new alt.flame groups and
all groups starting with u (university groups) other
than UK groups (which will be queried for as usual.)
TTTTIIIIPPPPSSSS AAAANNNNDDDD TTTTRRRRIIIICCCCKKKKSSSS
Tin can be pretty much be navigated by using the four cursor
keys. The left arrow key goes up a level, the right arrow
key goes down a level, the up arrow key goes up a line (page
at article viewer level) and the down arrow key goes down a
line (page at article viewer level).
The following newsgroups provide useful information
concerning news software:
-news.software.readers (info. about news user agents
tin,rn,nn,vn etc.)
-news.software.nntp (info. about NNTP)
-news.software.b (info. about news transport agents
Bnews,Cnews and INN)
-news.answers (Frequently Asked Questions (FAQ) about
many different themes)
Many prompts (i.e. 'Mark everything as read? (y/n): y')
within _t_i_n offer a default choice that the cursor is
positioned on. By pressing <CR> the default value is taken.
Many prompts (i.e. 'Post subject []>') within _t_i_n can be
aborted by pressing ESC.
When _t_i_n is run in an xterm window it will resize itself
each time the xterm is resized.
_T_i_n will reread the active file at set intervals to show any
newly arrived news.
XXXXTTTTEEEERRRRMMMM BBBBUUUUTTTTTTTTOOOONNNNSSSS
If the environment variable _T_E_R_M is set to _x_t_e_r_m, then
button pressing can be used to select groups and articles.
In the group selection menu, if the mouse is pointing before
the groups listing region the previous page is selected
(just like b). If the mouse is pointing after the groups
listing region the next page is selected (just like space).
If the mouse is pointing at a group then:
Page 26 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
left button moves to the group pointed at.
other buttons moves to and selects the group pointed at.
Just like <CR>.
In the article menu, if the mouse is pointing before the
article listing region the previous page is selected (just
like b). If the mouse is pointing after the article listing
region the next page is selected (just like space). If the
mouse is pointing at an article then:
left button moves to the article pointed at.
centre button reads next unread article from that pointed
at. Just like <TAB>.
right button reads article pointed at. Just like <CR>.
In the thread menu, if the mouse is pointing before the
article listing region the previous page is selected (just
like b). If the mouse is pointing after the article listing
region the next page is selected (just like space). If the
mouse is pointing at an article then:
left button moves to the article pointed at.
centre button reads next unread article from that pointed
at. Just like <TAB>.
right button reads article pointed at. Just like <CR>.
In the spool selection menu, if the mouse is pointing before
the spool listing region the previous page is selected (just
like b). If the mouse is pointing after the spool listing
region the next page is selected (just like space). If the
mouse is pointing at a spool selection then:
left button moves to the spool pointed at.
other buttons moves to and selects the spool pointed at.
Just like <CR>.
In other menus and areas button pressing reverts back to
usual cut and paste of xterm, but after one click of any
button.
FFFFIIIILLLLEEEESSSS
$_H_O_M_E/._n_e_w_s_r_c subscribed to newgroups.
$_H_O_M_E/._n_e_w_s_a_u_t_h ``nntpserver password'' pairs for NNTP
servers that require authorization.
Page 27 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
$_H_O_M_E/._t_i_n/_t_i_n_r_c options.
$_H_O_M_E/._t_i_n/_a_t_t_r_i_b_u_t_e_s
contains user specified group
attributes.
$_H_O_M_E/._t_i_n/._i_n_d_e_x newsgroups index files directory.
$_H_O_M_E/._t_i_n/._m_a_i_l_i_d_x mailgroups index files directory.
$_H_O_M_E/._t_i_n/._s_a_v_e_i_d_x saved newsgroups index files directory.
$_H_O_M_E/._t_i_n/_a_c_t_i_v_e._m_a_i_l
active file of users mailgroups.
$_H_O_M_E/._t_i_n/_a_c_t_i_v_e._s_a_v_e
active file of users saved newsgroups.
$_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s
address to add to when replying through
mail.
$_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s
address to send bug reports to.
$_H_O_M_E/._t_i_n/_k_i_l_l article kill and auto-selection file.
$_H_O_M_E/._t_i_n/_o_r_g_a_n_i_z_a_t_i_o_n
string to replace default organization.
$_H_O_M_E/._t_i_n/_p_o_s_t_e_d history of articles posted by user.
$_H_O_M_E/._t_i_n/_r_e_p_l_y_t_o host address to use in ``Reply-To:''
mail header.
$_H_O_M_E/._s_i_g_n_a_t_u_r_e signature.
$_H_O_M_E/._S_i_g signature.
$_H_O_M_E/._s_i_g_f_i_x_e_d fixed part of a randomly generated
signature.
/_u_s_r/_l_i_b/_n_e_w_s/_m_o_t_d News message of the day file.
/_u_s_r/_l_i_b/_n_e_w_s/_n_e_w_s_g_r_o_u_p_s
Short description of all newsgroups.
/_u_s_r/_l_i_b/_n_e_w_s/_s_u_b_s_c_r_i_p_t_i_o_n_s
List of newsgroups to subscribe first
time user to.
BBBBUUUUGGGGSSSS
PPPPaaaaggggeeee 22228888 MMMMaaaarrrrcccchhhh 9999,,,, 1111999999994444
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
There are bugs somewhere among the creeping featurism. Any
bugs found should be reported by the 'B' (bug report)
command.
Coredumps when setting certain toggle options from the
options menu at article viewer level.
Coredumps when killing last article in a thread at article
viewer level.
HHHHIIIISSSSTTTTOOOORRRRYYYY
Based on the _t_a_s_s newsreader that was developed by Rich
Skrenta and posted to alt.sources in March 1991. Tass was
itself heavily influenced by NOTES which was developed at
the University of Illinois by Ray Essick and Rob Kolstad in
1982.
v1.0 PL0 (full) was posted in 8 parts to alt.sources on 23
Aug 1991.
v1.0 PL1 (full) was posted in 8 parts to alt.sources on 03
Sep 1991.
v1.0 PL2 (full) was posted in 9 parts to alt.sources on 24
Sep 1991.
v1.0 PL3 (patch) was posted in 4 parts to alt.sources on 30
Sep 1991.
v1.0 PL4 (patch) was posted in 2 parts to alt.sources on 02
Oct 1991.
v1.0 PL5 (patch) was posted in 4 parts to alt.sources on 17
Oct 1991.
v1.0 PL6 (patch) was posted in 5 parts to alt.sources on 27
Nov 1991.
v1.0 PL7 (patch) was posted in 2 parts to alt.sources on 27
Nov 1991.
v1.1 PL0 (full) was posted in 11 parts to alt.sources on 13
Feb 1992.
v1.1 PL1 (full) was posted in 12 parts to alt.sources on 24
Mar 1992.
v1.1 PL2 (patch) was posted in 4 parts to alt.sources on 30
Mar 1992.
v1.1 PL3 (full) was posted in 15 parts to alt.sources on 13
May 1992.
v1.1 PL4 (full) was posted in 15 parts to alt.sources on 22
Jun 1992.
v1.1 PL5 (patch) was posted in 7 parts to alt.sources on 11
Aug 1992.
v1.1 PL6 (full) was posted in 15 parts to alt.sources on 14
Sep 1992.
v1.1 PL7 (patch) was posted in 10 parts to alt.sources on 15
Nov 1992.
v1.1 PL8 (patch) was posted in 6 parts to alt.sources on 06
Dec 1992.
v1.1 PL9 (patch) was posted in 3 parts to alt.sources on 20
Page 29 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
Mar 1993.
v1.2 PL0 (full) was posted in 14 parts to alt.sources on 25
May 1993.
v1.2 PL1 (patch) was posted in 8 parts to alt.sources on 14
Jul 1993.
v1.2 PL2 (patch) was posted in ?? parts to alt.sources on ??
Sep 1993.
CCCCRRRREEEEDDDDIIIITTTTSSSS
Rich Skrenta author of tass v3.2 which this newsreader
used as its base.
Bill Davidsen author of envarg.c environment variable
reading routine.
Mike Gleason author of sigfile.c random signature
generation routines. Arnold Robbins author
of strftime.c date formatting routine.
Jim Robinson co-author of kill.c article kill and auto-
selection routines.
Rich Salz author of wildmat.c pattern matching and
parsedate.y date parsing routines.
Dave Taylor author of curses.c from the elm mailreader.
Chris Thewalt author of getline.c emacs style editing
routine.
Mark Tomlinson for porting _t_i_n to the AmigaDOS operating
system.
Andreas Wrede for porting _t_i_n to the OS/2 operating system.
Dieter Becker for generously posting certain releases for
me when my net connection was removed by a
group of very short sighted people.
I wish to thank the following people for supplying patches:
David Abbott, Earle Ake, Joachim Astel, Anton Aylward,
George Baltz, Paul Bauwens, Dieter Becker, Dan Berry, David
Binderman, Fokke de Boer, Mark Boucher, Herman ten Brugge,
Leila Burrell-Davis, Peter Castro, Robert Claeson, Steven
Cogswell, Don Costello, Bryan Curnutt, Ned Danieley, Chris
Davies, John Davis, Tom Dickey, Bryan Dongray, Craig
Durland, Kirk Edson, Stefan Elf, Rob Engle, Brent Ermlick,
Olle Eriksson, Michael Faurot, Werner Fleck, Callum Gibson,
Mike Glendinning, Philippe Goujard, Carl Hage, Paul Halsema,
Ed Hanway, Scott Hauck, Per Headland, Daniel Hermans, Jose
Herrero, Tom Hite, Torsten Homeyer, Tommy Hsieh, Steve Hunt,
Page 30 March 9, 1994
TTTTIIIINNNN((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222)))) TTTTIIIINNNN((((1111))))
Pieter Immelman, Robbin Johnson, Nelson Kading, Fritz
Kleeman, Dwarven Knight, Karl-Koenig Koenigsson, Martin
Kraemer, Kris Kugel, Geoff Lane, Alex Lange, Alain Lasserre,
Marty Leisner, Hakan Lennestal, Otto Lind, Richard Lloyd,
Clifford Luke, David MacKenzie, Hugh Mahon, Kazushi
Marukawa, Owen Medd, Soren Moller, Sergio Morales, Michael
Morrell, Klaus Mueller, Udo Munk, James Nugen, Jeb Palmer,
Neil Parker, Tom Parry, Jim Patterson, Walter Pelissero,
Colin Perkins, Eric Peterson, Tim Pierce, Bill Poitras,
Wolfgang Prediger, Ted Richards, Ollivier Robert, Jim
Robinson, Stephen Roseman, Clifton Royston, Nickolay Saukh,
Rich Salz, Gary Sanders, John Sauter, Christopher Sawtell,
John Schmitz, Bart Sears, Karl-Olav Serrander, Doug Sewell,
Philip Shearer, Mark Smith, Steve Spearman, Cliff Stanford,
Steve Starck, Jason Steiner, Ed Sznyter, Derek Terveer,
Julian Thompson, Andry Timonin, Mark Tomlin, Michael Traub,
Adri Verhoef, Paul Vickers, Cary Whitney, Greg Woods, Lloyd
Wright
I wish to thank the following people for bug
reports/comments:
Jack Applin, Klaus Arzig, Scott Babb, Reiner Balling,
Preston Bannister, Bill de Beabien, Volker Beyer, Etienne
Bido, Roger Binns, Georg Biehler, Jean-Marc Bonnaudet, Eric
Bowles, Sean Brady, Ian Brown, Andreas Brosig, Craig Bruce,
Brett Carver,Tom Czarnik, Dave Datta, Mat Davis, Karl
Denninger, Klaus Dimmler, David Donovan, Peter Dressler,
Gerhard Ermer, Hugh Fader, Miguel Farah, Joachim Feld, Paul
Fox, Jay Geertsen, Herschel Gelman, Bernhard Gmelch, Jason
Haar, Viet Hoang, Andy Jackson, Joe Johnson, Ralph Jud,
Cyrill Jung, Kuo-Chein Kai, Tonis Kelder, Hans-Juergen
Knopp, Sridhar Komandur, Tom Kovar, Bernhard Kroenung,
Murray Laing, Per Lindqvist, Eric Litman, Bob Lukas, Michael
Marshall, Kazushi Marukawa, Olaf Mittelstaedt, Phillip
Molloy, Phil Molyneux, Toni Metz, Greg Miller, Deeptendu
Majumder, Klaus Neuberger, Otto Niesser, Reiner Oelhaf, Alex
Pakter, John Palkovic, Dave Pascoe, Wolf Paul, Andrew
Phillips, Stefan Rathmann, Jon Robinson, David Ross, Jonas
Rwgmyr, Malkani Sanjay, Daemon Schaefer, Dean Schrimpf,
Klamer Schutte, Fredy Schwatz, Dave Schweisguth, Bernd
Schwerin, Don Sheythe, Chris Smith, Daniel Smith, Richard
Stanton, Ralf Stephan, Hironobu Takahashi, Ken Taylor, Tony
Travis, Paul Verket, Sven Werner, Dick Wexelblat, Paul Wood,
Gregory Woodbury, Norm Yamane, Blair Zajac, Orest Zboroski,
Thomas Ziegler
AAAAUUUUTTTTHHHHOOOORRRR
Iain Lea (iain.lea@erlm.siemens.de)
Page 31 March 9, 1994